home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 2.iso / bin / helpfile < prev    next >
Text File  |  1996-11-11  |  24KB  |  454 lines

  1.      The purpose of this "help" file is to provide information about
  2.      initiating viewing of the v6.1 CD form of the Developer Toolbox.
  3.      Areas discussed are:
  4.  
  5.           0) if your CDROM drive is not mounted as /CDROM
  6.           1) location of Developer Toolbox "help" documentation
  7.           2) prerequisites to satisfy before starting any viewing
  8.           3) how to do the viewing
  9.           4) essential information about the viewing process
  10.           5) files placed on your workstation while running viewDT
  11.  
  12.      0) if your CDROM drive is not mounted as /CDROM
  13.      -------------------------------------------
  14.  
  15.           Throughout this document we presume you have the DT CD
  16.           mounted as /CDROM. Some sites will choose to mount the CDROM
  17.           drive elsewhere, or will have more than one CDROM drive. You
  18.           will need to know what your system's directory name is, if it
  19.           is other than /CDROM, and employ it accordingly in your use
  20.           of these instructions. The most direct way to ascertain under
  21.           what directory name the CDROM device is mounted as is to run
  22.           the following command in a shell window:
  23.  
  24.                % more /etc/fsd.tab
  25.  
  26.           For example, the /etc/fsd.tab file of the system on which
  27.           these notes were written contains the following:
  28.  
  29.      /dev/dsk/dks0d4s7 /CDROM efs ro,sock=/tmp/.mediadXXXXXX 0 0
  30.      /dev/rmt/tps0d5nr /tape archive opts=NA,sock=/tmp/.mediadXXXXXX 0 0
  31.  
  32.           If you don't see the string "CDROM," the most commonly
  33.           employed alternative name is "cdrom." You will need to
  34.           substitute our use of "CDROM" in command sequences below,
  35.           with whatever your system is using as "CDROM".
  36.  
  37.      1) location of Developer Toolbox "help" documentation
  38.      ---------------------------------------------
  39.  
  40.           A printed version of this file is the actual liner notes of
  41.           the Developer Toolbox CDs. It is the oldest and most out of
  42.           date version of the information. The CDs have the next most
  43.           current version of this file. It is on all DT CDs in
  44.           /CDROM/bin/helpfile. Also on each CD, is a superset of this
  45.           file that describes this and other helpful information
  46.           regarding use of the Toolbox. It is located via the Help
  47.           button (with the image of a hawk) on the TOP/HUB entry page
  48.           of the Toolbox (a text only version of this
  49.           /CDROM/toolbox/DThelp.html file is to be found in
  50.           /CDROM/toolbox/DThelp.txt). As is typical, the CD version of
  51.           this file is a snapshot of the live one found via the
  52.           https://www.sgi.com/toolbox/ secure web house URL. Don't
  53.           confuse the Help pull-down menu in the upper-right corner of
  54.           the Netscape browser window, with our "Help" icon button. The
  55.           browser pull-down menu will take you to information about
  56.           Netscape itself.
  57.  
  58.      2) prerequisites to satisfy before starting any viewing
  59.      -------------------------------------------
  60.  
  61.           There are some prequisites you will want to ensure are
  62.           satisfied before you attempt to view anything on the
  63.           Developer Toolbox. There are two versions of the following
  64.           information: one for people on a system running IRIX 6.2, and
  65.           the other for people running IRIX 5.3 (or anything else prior
  66.           to IRIX 6.2).
  67.  
  68.        A. For people running viewDT on an IRIX 6.2 system:
  69.  
  70.             i. Make sure you have all the Netscape helper programs
  71.                installed.
  72.  
  73.                You can verify you have IRIX 6.2-released versions of
  74.                the following subsystems containing the necessary
  75.                netscape helper apps by running the versions command and
  76.                comparing the described version numbers to the
  77.                following:
  78.  
  79.                   + showcase -- IRIS Showcase 3.4
  80.                          showcase.sw.showcase
  81.                   + inventor_eoe -- Inventor Execution Only
  82.                     Environment, 2.1.2
  83.                          inventor_eoe.sw.2_0
  84.                   + imgtools -- ImageVision Tools, 3.0
  85.                          imgtools.sw.tools
  86.                   + il_eoe -- ImageVision Library Execution Only
  87.                     Environment, 2.5.1
  88.                          il_eoe.sw.c++
  89.                          il_eoe.sw.tiff
  90.                          il_eoe.sw.sgi
  91.                          il_eoe.sw.jfif
  92.                          il_eoe.sw.gif
  93.                   + dmedia_eoe -- IRIS Digital Media Execution
  94.                     Environment, 6.2
  95.                          dmedia_eoe.sw.audio
  96.                          dmedia_eoe.sw.common
  97.                          dmedia_eoe.sw.lib
  98.                          dmedia_eoe.sw.soundscheme
  99.                          dmedia_eoe.sw.midi
  100.                          dmedia_eoe.sw.tools
  101.                          dmedia_eoe.sw.video
  102.                   + dps_eoe -- Display PostScript/X, 2.0.5 based on
  103.                     PostScript Level 2
  104.                          dps_eoe.sw.dps
  105.                     This subsystem is not needed for people who use
  106.                     something other than xpsview(1) to view PostScript
  107.                     files on their system. You can arrange to use a
  108.                     different PostScript viewer via your personal
  109.                     $HOME/.mailcap file and an appropriate substitute
  110.                     helper program (e.g. ghostview).
  111.                     It is worth mentioning that if you do not have your
  112.                     own $HOME/.mailcap and/or $HOME/.mime.types files,
  113.                     versions of these will be created for you.
  114.                     $HOME/.mime.types is used to augment the global
  115.                     default definitions
  116.                     (/usr/local/lib/netscape/mime.types) of the file
  117.                     extensions which correspond to a particular mime
  118.                     type. $HOME/.mailcap is used to augment the global
  119.                     default definitions
  120.                     (/usr/local/lib/netscape/mailcap) of the mime types
  121.                     which correspond to a particular helper
  122.                     application. There will be some Toolbox-specific
  123.                     definitions added to both of these files to help
  124.                     support the viewing of Developer Toolbox content.
  125.  
  126.        B. For people running viewDT on an IRIX 5.3 (i.e. a non IRIX
  127.           6.2) system.
  128.  
  129.             i. Make sure you have all the Netscape helper programs
  130.                installed.
  131.                (Available on the Descktop Special Edition (DSE) 1.1 CD)
  132.  
  133.                You can verify you have sufficiently current versions of
  134.                the following subsystems containing the necessary
  135.                netscape helper apps by running the versions command and
  136.                comparing the described version numbers to the
  137.                following:
  138.  
  139.                   + showcase -- IRIS Showcase 3.3.3
  140.                          showcase.sw.showcase
  141.                   + inventor_eoe -- Inventor Execution Only
  142.                     Environment, 2.1.1
  143.                          inventor_eoe.sw.inventor
  144.                   + imgtools -- ImageVision Tools, 2.3
  145.                          imgtools.sw.tools
  146.                   + il_eoe -- ImageVision Library Execution Only
  147.                     Environment, 2.5
  148.                          il_eoe.sw.c++
  149.                   + dmedia_tools -- IRIS Digital Media Tools, 5.5
  150.                          dmedia_tools.sw.movietools
  151.                          dmedia_tools.sw.soundtools
  152.                   + dmedia_eoe -- IRIS Digital Media Execution
  153.                     Environment, 5.5
  154.                          dmedia_eoe.sw.audio
  155.  
  156.                If you do not have the above subsystems loaded, you can
  157.                find them on the DSE 1.1 CD, the second CD included in
  158.                the v5.1 DT. It contains all the inst images needed to
  159.                satisfy the above prerequisites.
  160.  
  161.                If you do not have the v5.1 DT, look for a copy of the
  162.                DSE 1.1 CD with your collection of IRIX 5.3 CDs. If it
  163.                is not there, you can also access the DSE 1.1 contents
  164.                at https://www.sgi.com/toolbox/DSE1.1/. If you are
  165.                unable to do this, contact the Developer Program at
  166.                devprogram@sgi.com, or on the phone either via
  167.                1-800/770-3033, or 415/933-3033, or by fax via
  168.                415/969-6327, and tell them you need a copy of the DSE
  169.                1.1 CD sent to you through the post.
  170.  
  171.            ii. Make sure you have all the appropriate patches
  172.                installed.
  173.  
  174.                Not all subsystems in these patches will install -- you
  175.                will only be allowed to install subsystems corresponding
  176.                to base software already installed. In other words,
  177.                always attempt to install the entire patch and don't be
  178.                alarmed about the parts which do not install.
  179.  
  180.                Some of the patch locations mentioned below also contain
  181.                a recommended patch list. It is helpful to know your
  182.                hardware and O.S. level in order to install the
  183.                recommended patches. We are working to have this
  184.                information included in the toolbox. We do have an
  185.                abbreviated list below of seven key patches for IRIX
  186.                5.3, current as of August 14, 1996. All of them are
  187.                replacements of similar IRIX 5.3 patches recommended in
  188.                the v5.1 DT. These patches are also available on the
  189.                toolbox in /toolbox/dist/5.3/patches/
  190.  
  191.                Patch 1412 - IRIX 5.3 Networking Rollup Patch
  192.                     3MBs 8/13/96
  193.                Patch 1268 - 5.3/5.3xfs combined kernel rollup patch
  194.                     8MBs 6/6/96
  195.                Patch 1264 - XFS rollup patch for 5.3
  196.                     30MBs 5/1/96
  197.                Patch 1102 - NFS roll up
  198.                     2MBs 4/3/96
  199.                Patch 1095 - Scrolled Window patch
  200.                     2MBs 1/19/96
  201.                X server roll up Choose at most one of the following
  202.                     Patch 1187 - excluding Impact graphics (for
  203.                     non-Impact systems)
  204.                          14MBs 3/22/96
  205.                     Patch 1271 - only for Impact graphics (for Impact
  206.                     systems)
  207.                          2MBs 5/1/96
  208.  
  209.                For those people with support contracts these patches
  210.                are available in the Support Folio quarterly release
  211.                CDs, and also inside Silicon Surf's SurfZone (to
  212.                register, go to http://www.sgi.com/Misc/zone.html), in
  213.                Supportfolio Online's "Silicon Graphics's support
  214.                patches on the web" entry page.
  215.  
  216.           iii. Possible Inst Warning Messages and Conflicts:
  217.  
  218.                There are two different types of warning messages you
  219.                might see which are benign. When you run the inst
  220.                command "keep Same" as part of the prerequisite install
  221.                sequence, you might see the warning message "No matches
  222.                were found." You can safely ignore it.
  223.  
  224.                After running the inst command "go," you might see some
  225.                conflicts concerning subsystems not presently installed
  226.                on your system. These should offer a single resolution
  227.                to the conflict. The choice will be to not install a
  228.                particular patch subsystem. It is quite safe to select
  229.                this single choice resolution to the conflict.
  230.  
  231.                Rhere is one error condition which might occur which
  232.                will require some work on your part. In a shell window,
  233.                run the command "versions tooltalk_eoe". If you see the
  234.                subsystems "tooltalk_eoe.sw.links" and
  235.                "tooltalk_eoe.sw.runtime" listed, there is nothing more
  236.                to do. Otherwise, before performing the prerequisite
  237.                install sequence, you must locate your "IRIX 5.3" CD and
  238.                install the two tooltalk_eoe subsytems mentioned above.
  239.                If for some reason you are unable to install these
  240.                subsytems, then you will be unable to view the only two
  241.                movies which are present on the Developer Toolbox v6.1
  242.                CD.
  243.  
  244.            iv. A PostScript Viewing Issue:
  245.  
  246.                You will have nothing more to do, if you have already
  247.                installed the 5.3 subsystem, dps_eoe.sw.dps, which
  248.                provides the Netscape viewer application xpsview.
  249.                Without this subsystem you will not be able to view
  250.                PostScript files on the Developer Toolbox. Of course,
  251.                you can arrange to use a different viewing program via
  252.                your personal $HOME/.mailcap file and an appropriate
  253.                substitute helper program.
  254.  
  255.                It is worth mentioning that if you do not have your own
  256.                $HOME/.mailcap and/or $HOME/.mime.types files, versions
  257.                of these will be created for you. $HOME/.mime.types is
  258.                used to augment the global default definitions
  259.                (/usr/local/lib/netscape/mime.types) of the file
  260.                extensions which correspond to a particular mime type.
  261.                $HOME/.mailcap is used to augment the global default
  262.                definitions (/usr/local/lib/netscape/mailcap) of the
  263.                mime types which correspond to a particular helper
  264.                application. There will be some Toolbox-specific
  265.                definitions added to both of these files to help support
  266.                the viewing of Developer Toolbox content.
  267.  
  268.      3) how to do the viewing
  269.      --------------------
  270.  
  271.           To view the Developer Toolbox, simply type the following
  272.           command:
  273.  
  274.                % /CDROM/bin/viewDT
  275.  
  276.           Move the cursor into the Toolbox window which pops up. Now
  277.           press the "Enter" key on your keyboard. This command will
  278.           copy about 10 megabytes of Developer Toolbox viewing
  279.           utilities to your local disk, if they have not already been
  280.           placed there by a previous viewDT session. The Developer
  281.           Toolbox viewing utilities will be upgraded with a newer
  282.           version, if one is found on the CD. Specifically, to the
  283.           directory /usr/tmp, unless the environment variable TMPDIR is
  284.           defined. The next time you run, the command will not need to
  285.           recopy this data. Although we recommend you keep this data
  286.           local, you can elect to have it removed by running the
  287.           command "viewDT -r" rather than "viewDT". If you would prefer
  288.           to have the 10 Meg stored in a different directory you can
  289.           also do this by running the command "viewDT -f
  290.           <new_directory>" instead of "viewDT"
  291.  
  292.           There are several modes in which viewDT can be run:
  293.  
  294.           viewDT [-r] [-f tmp_dir] [-C CD_dir]
  295.                This is the standard mode outlined above, with one
  296.                exception. The -C option allows viewDT to be run from
  297.                the DT_utilities directory rather than from a DT CD. In
  298.                fact, the -C option must be used when running from the
  299.                DT_utilities directory. You might need to do this when
  300.                using a more advanced version of the DT_utilities with
  301.                an older CD version of the Developer Toolbox. Such a
  302.                condition does not currently exist.
  303.           viewDT -u [-f tmp_dir]
  304.                This version of the command is used to just create the
  305.                DT_utilities directory. It is most often used as one of
  306.                the steps used to install a fixDT patch for a particular
  307.                DT CD. The -f option is only needed when the
  308.                DT_utilities directory should be placed in a particular
  309.                directory.
  310.           viewDT -R [-f tmp_dir]
  311.                This version of the command is used to just remove the
  312.                DT_utilities directory. The -f option is only needed
  313.                when the DT_utilities directory exists in a non-standard
  314.                directory.
  315.  
  316.      4) essential information about the viewing process
  317.      -----------------------------------------
  318.  
  319.           There is some essential information which will help you
  320.           manage your workstation resources and your time as you view
  321.           and use the Developer Toolbox CD.
  322.  
  323.              o First off, activating the "Help" button produces this
  324.                help file, which you probably already know since you are
  325.                reading this.
  326.  
  327.              o You may see a Netscape "Question" window informing you
  328.                of a Netscape lock file. You will see this if you have
  329.                Netscape running in another window. If you do not care
  330.                if you will be unable to save bookmarks and other
  331.                history in this new window then just click "OK".
  332.                Otherwise, click "Cancel", close the other Netscape
  333.                window and reselect "View".
  334.  
  335.              o If you are not connected to the Web and the Internet,
  336.                then there are a number of Toolbox features you will not
  337.                be able to access. Specifically, Web references to
  338.                places outside of the Developer Toolbox CD and the
  339.                pheedback mechanism.
  340.  
  341.              o The first time you access or follow a link to a place
  342.                not on the current CD, the utility dtCDmgr will be run.
  343.                It will allow you to specify how to mount the needed CD
  344.                and any other CDs which will also be needed. The
  345.                helpfile for dtCDmgr appears below.
  346.  
  347.              o When the Toolbox window is present, it shows the server
  348.                status of both the "http" server, the web server, as
  349.                well as the "oksvr" server, the server for the search
  350.                engine. It takes time for the two servers to be started.
  351.  
  352.              o There are a separate pair of servers created for each
  353.                user viewing the CD. It is literally your own personal
  354.                web site. You may want to keep these servers running if
  355.                you plan to periodically access the Toolbox. The way to
  356.                do this is to not "Quit" from the Toolbox window, but
  357.                simply leave the window running on your console either
  358.                in its opened form or stowed as an icon.
  359.  
  360.              o Activating the "View" button for the first time starts
  361.                up the httpd and oksvr servers and then starts up
  362.                netscape. Upon exiting the Netscape window, the little
  363.                Toolbox window returns to your console screen.
  364.                Subsequent activations of the "View" button simply
  365.                invokes netscape again, since the two servers are
  366.                already running.
  367.  
  368.              o When you have quit/exited from the Netscape window, and
  369.                the little Toolbox window has returned, you will see the
  370.                "running" status of the two servers displayed and their
  371.                respective port numbers.
  372.  
  373.              o Netscape is fairly consumptive of memory, so you may
  374.                want to exit from netscape, leaving the servers running.
  375.                Unlike netscape, the servers consume very little memory.
  376.                The binary filename for the http server is
  377.                "dt_httpd.exe". The binary filename for the oksvr server
  378.                is "dt_oksvr". These have both been renamed to avoid
  379.                confusion with any httpd/oksvr executables already
  380.                running on your system. A helpful way to see how much
  381.                memory netscape is currently using is with the gmemsuage
  382.                program, the graphical memory usage display tool
  383.                included on the DT.
  384.  
  385.      5) files placed on your workstation while running viewDT
  386.      -----------------------------------------------
  387.  
  388.           Files are placed on your workstation to support the running
  389.           of the two servers.
  390.  
  391.           If you don't already have $HOME/.netscape-preferences,
  392.           $HOME/.mime.types, and/or $HOME/.mailcap files, then
  393.           instances will be created for you. You are likely to already
  394.           have these files if you run Netscape or some other web
  395.           viewer. These three files are the only files created by
  396.           viewDT which persist after you quit from it. Additionally,
  397.           the files $HOME/.mime.types and $HOME/.mailcap have some
  398.           lines needed to correctly view certain types of files on the
  399.           Toolbox. In both files you will see a comment line of the
  400.           form "#--TOOLBOX_Compliant_File----". Please do not remove
  401.           these lines. They mark your files as having the necessary
  402.           definitions present. Just after this line will be the
  403.           definitions bounded by comment lines of the form
  404.           "#--TOOLBOX_SPECIFIC_THINGS".
  405.  
  406.           In the $HOME directory, you will find the file .dtcdresource.
  407.           It contains a list of the CDROM drives and/or directories
  408.           where dtCDmgr has been directed to find DT CDs. This file is
  409.           used to save the user from re-specifying these locations
  410.           every time viewDT is invoked.
  411.  
  412.           In the /tmp directory, you will find two files (described
  413.           below) for each user. These files only exist while the viewDT
  414.           is running. The <n> at the end of their file name,
  415.           corresponds to the port number of the httpd server for those
  416.           files. For instance, .cdlocation_8080 corresponds to the
  417.           mount point of the CDROM for the httpd server listening to
  418.           port 8080.
  419.  
  420.           In the /tmp directory, you may find the directory .portlock.
  421.           It is used when searching for free ports from which to run
  422.           the httpd and oksvr. There is the possibility an unexpected
  423.           error will fail to remove this directory, which must then be
  424.           removed manually.
  425.              o .cdlocation_<n> - which defines the mount point of the
  426.                CDROM.
  427.              o .userhome_<n> - which defines the absolute path location
  428.                of your $HOME directory.
  429.  
  430.           The $HOME/.www directory is a transitory directory. It only
  431.           exists while viewDT is running. In it, you will find several
  432.           files and directories:
  433.              o .DT_DocRootFile - a file used by Developer Toolbox
  434.                cgi-bin scripts to point to the Developer Toolbox
  435.                document root. In our case, it points to
  436.                $HOME/.www/htdocs.
  437.              o .DT_OksvrRoot - a file used by Developer Toolbox cgi-bin
  438.                scripts to point to the Developer Toolbox searchtools
  439.                directory. In our case, it points to
  440.                $HOME/.www/htdocs/toolbox/searchtools.
  441.              o cgi-bin - a link to the Toolbox cgi-bin directory
  442.                <DT_utilities>//cgi-bin/
  443.              o conf - the directory of configuration files for your
  444.                Toolbox web-on-a-CD.
  445.              o htdocs - the Document Root of your Toolbox web-on-a-CD.
  446.              o icons - a link to the directory <DT_utilities>/icons/
  447.                . It is the directory of the standard X bitmap icons.
  448.              o logs - log directory of your Toolbox web-on-a-CD.
  449.                It contains the access_log, agent_log, error_log, and
  450.                referer_log log files. It also contains the port numbers
  451.                of the httpd server and the oksvr server in the
  452.                httpd.port and oksrv.port files. It contains the process
  453.                ID of the httpd server in the httpd.pid file.
  454.